# 交叉编译工具链

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

# 概述

交叉编译工具链是在主机（如x86_64架构的Ubuntu）上编译目标设备（如ARM架构的Quectel Pi H1）程序的必备工具。本文档介绍如何获取和部署Quectel Pi H1的交叉编译工具链。

# 系统要求

- **操作系统**：Ubuntu 22.04（推荐）

- **架构**：x86_64

- **磁盘空间**：至少5 GB可用空间

# 下载工具链

## 下载地址

点击下载：[qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip](<https://developer.quectel.com/doc/files/qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip>)

## 工具链信息

- **平台**：Qualcomm QCM6490

- **架构**：ARMv8-2a

- **图形系统**：Wayland

- **版本**：1.3-ver.1.1

# 部署工具链

## 解压安装包

下载完成后，解压ZIP文件：

```bash
unzip qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip
```

## 执行安装脚本

给安装脚本添加可执行权限并运行：

```bash
chmod +x qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh
./qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh
```

## 选择安装目录

执行脚本后，系统会提示输入安装目录：

- **默认目录**：直接按Enter键使用默认路径

- **自定义目录**：输入您想要的安装路径

安装完成后，脚本会提示SDK环境的使能方式。

## 部署示例

```{image} images/image_Zf61bG8xZoZclQxcrNJc7TICnif.webp
:width: 942px
:height: 179px
```

# 使用工具链

## 环境变量配置

部署完成后，需要在使用前配置环境变量。通常可以通过以下命令激活SDK环境：

```bash
source <安装目录>/environment-setup-armv8-2a-qcom-linux
```

> **提示**：将 *<安装目录>* 替换为您实际的安装路径。

## 验证安装

可以通过以下命令验证工具链是否正确安装：

```bash
$CC --version
```

如果显示交叉编译器的版本信息，说明工具链已成功部署。

# 常见问题

## Q1: 安装脚本执行失败？

**解决方法**：

- 确保脚本具有可执行权限

- 检查磁盘空间是否充足

- 确认系统版本为Ubuntu 22.04

## Q2: 环境变量配置后无效？

**解决方法**：

- 确认 *source* 命令执行成功

- 检查安装目录路径是否正确

- 尝试在新的终端窗口中重新执行 *source* 命令

## Q3: 如何让环境变量永久生效？

**解决方法**：

可以将 *source* 命令添加到 *~/.bashrc* 文件中：

```bash
echo "source <安装目录>/environment-setup-armv8-2a-qcom-linux" >> ~/.bashrc
source ~/.bashrc
```

# 下一步

成功部署交叉编译工具链后，您可以：

- 进行内核模块开发

- 编译设备驱动程序

- 构建应用程序

更多开发相关信息，请参考对应的开发文档。